home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / pca110.zip / INSTALL.DOC < prev    next >
Text File  |  1993-01-06  |  12KB  |  373 lines
  1.  
  2.  
  3.                 STANDARD MICROSYSTEMS CORPORATION
  4.  
  5.                           
  6.                            PC AGENT/SNMP
  7.  
  8.                 For EtherCard PLUS Family LAN adapters
  9.                 and TokenCard EliteSeries LAN adapters
  10.  
  11.  
  12.                         INSTALLATION GUIDE
  13.  
  14.  
  15.      This software is licensed by SMC for use by its customers only.
  16.           Copyright (c) 1992 Standard Microsystems Corporation.
  17.                      All rights reserved.                
  18.  
  19.  
  20. INTRODUCTION
  21. ------------
  22.  
  23. The PC AGENT/SNMP is a TSR(Terminate but Stay Resident program) which
  24. allows the targeted PC workstation to be remotely managed by a SNMP
  25. manager station(e.g a work station running SMC/EliteView) on the
  26. network through SNMP(Simple Network Management Protocol). The PC
  27. AGENT/SNMP collects and maintains system and statistic information
  28. about the PC.  The SNMP manager can set and retrieve these
  29. information from the PC station with PC AGENT/SNMP loaded.
  30.  
  31.  
  32. SYSTEM REQUIREMENTS
  33. -------------------
  34.  
  35. The PC AGENT/SNMP can run on any XT/AT, EISA, or Micro Channel PC.
  36.  
  37. An MSDOS or PCDOS operating system is required, version 3.1 or above.
  38. An agent-compatible network driver must be resident in memory.  The
  39. SMC network drivers that are compatible with the PC AGENT/SNMP are :
  40.         NDIS Token_Ring driver - SMC8100.DOS (ver 1.00m and above)
  41.         NDIS Ethernet driver - SMCMAC.DOS (ver2.00n and above)
  42.         ODI Token_Ring driver - SMC8100.COM (ver 1.03 and above)
  43.         ODI Ethernet driver - SMC8000.COM (ver 3.03 and above)
  44.         IPX driver - IPX.COM (ver 1.00ab and above)
  45.         
  46.  
  47. The PC AGENT/SNMP TSR will occupy approximately 24K bytes and can be
  48. loaded into either high or low memory.
  49.  
  50. An IP address must be available if the agent needs to communicate
  51. with SNMP network management stations using TCP/IP protocol.
  52.  
  53. The PC AGENT/SNMP does not require any network operating system or
  54. protocol stack to be loaded.
  55.  
  56.  
  57. INSTALLATION PROCEDURE
  58. ----------------------
  59.  
  60. To load PC AGENT/SNMP, type
  61.  
  62.         PCAGENT  [configuration file]
  63.  
  64. The parameters in [] are optional.
  65.  
  66. A configuration file can be specified for the PC AGENT/SNMP. For
  67. details, see CONFIGURATION FILE CONTENTS.
  68.  
  69. The PC AGENT/SNMP consists of a single executable file, PCAGENT.EXE. 
  70. It can be executed at any time once an appropriate IPX, ODI or NDIS
  71. driver is in memory.
  72.  
  73. For example, the following lines in AUTOEXEC.BAT would be adequate to
  74. load the SMC Ethernet ODI driver(SMC8000) and PC AGENT/SNMP with
  75. PCDATA.CFG as the configuration file:
  76.  
  77.   LSL
  78.   SMC8000
  79.   PCAGENT PCDATA.CFG
  80.  
  81. The following lines in AUTOEXEC.BAT would be adequate to load the SMC
  82. Token Ring ODI driver(SMC8100) and PC AGENT/SNMP:
  83.  
  84.   LSL
  85.   SMC8100
  86.   PCAGENT PCDATA.CFG
  87.  
  88. The following lines in CONFIG.SYS and AUTOEXEC.BAT would be adequate
  89. to load a Token Ring NDIS driver and PC AGENT/SNMP:
  90.  
  91. In CONFIG.SYS:
  92.  
  93.   DEVICE=C:\NDIS\PROTOCOL.DOS /I:C:\NDIS
  94.   DEVICE=C:\NDIS\SMC8100.DOS
  95.  
  96. In AUTOEXEC.BAT :
  97.  
  98.   NETBIND
  99.   PCAGENT PCDATA.CFG
  100.  
  101. Note that PC AGENT/SNMP may be executed immediately after the driver
  102. is loaded, as in the examples above, or at any later time.  It may be
  103. convenient to have the PC AGENT/SNMP configuration files for the
  104. various PCs on a network server where they are controlled by a
  105. network administrator.  In this case, for example in a NetWare
  106. environment, the network administrator has allocated an user area on
  107. network drive F: for the various users' configuration files; the
  108. following lines might be in user Kathy's AUTOEXEC.BAT file:
  109.  
  110.   LSL
  111.   SMC8000
  112.   IPXODI
  113.   NETX
  114.   LOGIN
  115.   PCAGENT F:\USERS\AGTSTUFF\KATHY.CFG
  116.  
  117.  
  118. CONFIGURATION FILE CONTENTS
  119. ---------------------------
  120.  
  121. The PC AGENT/SNMP maintains a data base of configuration and
  122. statistical information in its RAM space.  The agent itself discovers
  123. or otherwise controls most of the data.  A few pieces of
  124. configuration information are assigned by the owner of the PC or by
  125. the network administrator, such as the name of the person who uses
  126. the PC and its location.  The configuration file is the mechanism by
  127. which these data are given to the agent.  Each line in the
  128. configuration file specifies the default value of a configuration
  129. entry.  These data are mostly optional.  If they aren't supplied to
  130. the agent, it won't supply them to network management workstations
  131. who query.  One item, the IP address of the agent (smcDosWsIpAdr), must
  132. be given if the agent has to be addressed across the cable by network
  133. management stations which use TCP/IP protocol.
  134.  
  135. When PC AGENT/SNMP is executed, it first examines its PC,
  136. initializing its data base accordingly.  After that, if the operator
  137. has given it a configuration file to look at, it reads the
  138. configuration file data, initializes those uninitialized data in its
  139. data base and in some cases, overwrites initialized data in the data
  140. base.  For example, the agent may initialize its description of
  141. display type to "EGA/VGA" (generic and non-descript) which the
  142. installer, via the configuration file, might replace with "ATI VGA
  143. Wonder w/512KB" to be more specific.
  144.  
  145. The syntax of lines in the configuration file is very simple:
  146.  
  147. DataItemName = DataItemValue
  148.  
  149. where DataItemName is a data variable name and DataItemValue is the
  150. value the variable should have.  Data variable names which can be set
  151. in the configuration file are listed below.  Variable names are case
  152. sensitive.
  153.  
  154. An example of a possible configuration file might be:
  155.  
  156.  ComStr = mypassword             => Read/write password for SNMP
  157.  sysName = Sally Jones             => Person who uses the PC
  158.  smcDosWsIpAdr = 129.254.2.3         => IP address of PC AGENT/SNMP
  159.  sysLocation = somewhere on earth    => Location of PC
  160.  smcDosWsPcTyp = IBM AT              => PC make and model
  161.  smcDosWsTrapDstAdr.1 = 129.254.2.1  => First IP address to send
  162.                                         alerts(traps) to
  163.  smcDosWsTrapDstPro.1 = 2         => Protocol for alerts 
  164.                                         (2=TCP/IP)
  165.  
  166.  
  167.  
  168.  
  169. Required data element :
  170. This data element is required if the agent has to communicate with
  171. SNMP network management stations using TCP/IP protocol.  Otherwise,
  172. it is only optional.
  173.  
  174. smcDosWsIpAdr
  175.  
  176.   This is the IP address for the PC AGENT/SNMP.  If the PC also has a
  177.   TCP/IP stack, the agent may be given the same or a different IP
  178.   address than the TCP/IP stack.  It is often convenient to assign the
  179.   agent its own IP address to avoid confusion about who is who.  Note
  180.   that the agent must be given its IP address in the configuration
  181.   file regardless of whether a stack is loaded on the PC with the same
  182.   IP address.  Since TCP/IP stacks vary widely in the way their IP
  183.   addresses are specified, the agent has no way of discovering the IP
  184.   address of such a stack.
  185.  
  186. Optional data elements :
  187. Data elements which an installer might desire to initialize via the
  188. configuration file.
  189.  
  190. ComStr
  191.  
  192.   This is the password which SNMP manager uses for read/write
  193.   operations. 
  194.  
  195. sysContact
  196.  
  197.   This is usually the person to call for help.  It is initialized by
  198.   the agent with SMC's technical support telephone number in the USA.
  199.  
  200. sysName
  201.  
  202.   This is usually the owner/user of the PC.  It is not initialized by
  203.   the agent.
  204.  
  205. sysLocation
  206.  
  207.   This is usually the physical location of the PC.  It is not 
  208.   initialized by the agent.
  209.  
  210. smcDosWsPcTyp
  211.  
  212.   This is the make and model of the PC.  It is not initialized by the
  213.   agent.
  214.  
  215. smcDosWsPcProc
  216.  
  217.   This is the processor type and whether there is a co-processor. The 
  218.   agent initializes it according to the processor it discovers on the 
  219.   PC.
  220.  
  221. smcDosWsPcBios
  222.  
  223.   This is the BIOS manufacturer and version number.  The PC tries to 
  224.   discern this by scanning for copyright notices in the BIOS area.
  225.  
  226. smcDosWsPcVideo
  227.  
  228.   This is the type of video adapter on the PC.
  229.  
  230.  
  231. smcDosWsTrapDstAdr.1
  232.  
  233.   In a TCP/IP network environment, this is the IP address(in decimal)
  234.   of a network management station to which traps(alerts) should be
  235.   sent in case an alarm situation occurs.  In an IPX network
  236.   environment, this is the IPX network address(in decimal) of the
  237.   network management station where traps should be sent.  There is a
  238.   maximum of 3 management stations where traps can be sent(Adr.1,
  239.   Adr.2, and Adr.3).
  240.  
  241. smcDosWsTrapDstPro.1
  242.  
  243.   This indicates the protocol in which traps should be sent to the
  244.   network management station with IP address or IPX network address
  245.   specified by smcDOSWsTrapDstAdr.1  
  246.   
  247.   A number is used to specified the protocol used :
  248.       2 = TCP/IP(Ethernet & TokenRing)
  249.       3 = IPX with Ethernet II frame type(Ethernet ONLY) 
  250.       4 = IPX with 802.2(LLC) frame type(Ethernet & TokenRing)
  251.       5 = IPX with SNAP frame type(Ethernet & TokenRing)
  252.       6 = IPX with 802.3 frame type(Ethernet ONLY) 
  253.  
  254. smcDosWsTrapDstAdr.2
  255.  
  256.   This is the second IP address or IPX network address of a network
  257.   management station to which traps (alerts) should be sent in case an
  258.   alarm situation occurs.  
  259.  
  260. smcDosWsTrapDstPro.2
  261.  
  262.   This indicates the protocol in which traps should be sent to the
  263.   network management station with IP address or IPX network address
  264.   specified by smcDOSWsTrapDstAdr.2  
  265.   
  266.   See smcDosWsTrapDstPro.1 for the number used to specify the
  267.   protocol. 
  268.  
  269.  
  270. smcDosWsTrapDstAdr.3
  271.  
  272.   This is the third IP address or IPX network address of a network
  273.   management station to which traps (alerts) should be sent in case an
  274.   alarm situation occurs.  
  275.  
  276. smcDosWsTrapDstPro.3
  277.  
  278.   This indicates the protocol in which traps should be sent to the
  279.   network management station with IP address or IPX address specified
  280.   by smcDOSWsTrapDstAdr.3  
  281.   
  282.   See smcDosWsTrapDstPro.1 for the number used to specify the
  283.   protocol. 
  284.  
  285.  
  286.  
  287. ERROR MESSAGES
  288. --------------
  289.  
  290.  
  291. PC AGENT/SNMP was not installed.
  292. Too many parameters in command line.
  293.  
  294.  
  295. PC AGENT/SNMP was not installed.
  296. Invalid parameter in command line.
  297.  
  298.  
  299. PC AGENT/SNMP was already installed.
  300.  
  301.  
  302. PC AGENT/SNMP was not installed.
  303. DOS version too old (below 3.10); need DOS 3.10 or above.
  304.  
  305.  
  306. PC AGENT/SNMP was not installed.
  307. Internal error (1) : Call SMC Technical Support.
  308.  
  309.  
  310. PC AGENT/SNMP was not installed.
  311. Internal error (2) : Call SMC Technical Support.
  312.  
  313.  
  314. PC AGENT/SNMP was not installed.
  315. PC AGENT/SNMP compatible network driver was not loaded.
  316.  
  317.  
  318. PC AGENT/SNMP was not installed.
  319. There is no network adapter for the driver.
  320.  
  321.  
  322. PC AGENT/SNMP was not installed.
  323. Unable to open configuration file <file name>.
  324.  
  325.  
  326.  
  327.  
  328. WARNING MESSAGES
  329. ----------------
  330.  
  331. PC AGENT/SNMP Configuration file error : 
  332.      invalid MIB variable <name>.
  333.      Line : < erroneous line in configuration file >
  334.  
  335.  
  336. PC AGENT/SNMP Configuration file error : 
  337.      invalid IP address <the IP address>.
  338.      Line : < erroneous line in configuration file >
  339.  
  340.  
  341. PC AGENT/SNMP Configuration file error : 
  342.      invalid numeric value for MIB variable.
  343.      Line : < erroneous line in configuration file >
  344.  
  345.  
  346. PC AGENT/SNMP Configuration file error : 
  347.      MIB variable <name> cannot be set from configuration file.
  348.      Line : < erroneous line in configuration file >
  349.  
  350.  
  351.  
  352. *****************************************************************
  353. Warning: PC AGENT/SNMP was not able to find a free interrupt vector
  354.          for application trap API.  External application programs
  355.          will not be able to issue traps.
  356. *****************************************************************
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367. EtherCard PLUS, TokenCard, and SuperDisk are trademarks, and SMC and
  368. Standard Microsystems are registered trademarks of Standard
  369. Microsystems Corporation.  Other trademarks mentioned herein belong
  370. to their respective companies.
  371.  
  372.  
  373.